home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / slrn_110.arc / SLEARN.DOC < prev    next >
Text File  |  1990-07-21  |  29KB  |  910 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                      | SLEARN (SALT learn utility) v1.10   |
  31.                      |                                     |
  32.                      | A SALT script creator for Telix     |
  33.                      |                                     |
  34.                      | Copyright (c) 1990 by Paul Roub     |
  35.                      | All Rights Reserved                 |
  36.                      |                                     |
  37.                      | Documentation printed July 22, 1990 |
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.                                     Contents
  45.  
  46.      Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  47.           Contacting the author  . . . . . . . . . . . . . . . . . . . .   1
  48.           ACKNOWLEDGEMENTS . . . . . . . . . . . . . . . . . . . . . . .   1
  49.           Notes  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  50.  
  51.      Why use SLEARN? . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  52.           What's the problem?  . . . . . . . . . . . . . . . . . . . . .   3
  53.           What's the solution? . . . . . . . . . . . . . . . . . . . . .   4
  54.  
  55.      Setup and Installation  . . . . . . . . . . . . . . . . . . . . . .   5
  56.  
  57.      Using SLEARN  . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  58.           NOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  59.           WARNING  . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  60.  
  61.      Command-Line Usage  . . . . . . . . . . . . . . . . . . . . . . . .   9
  62.  
  63.      Configuration Options . . . . . . . . . . . . . . . . . . . . . . .  11
  64.           Comm port address  . . . . . . . . . . . . . . . . . . . . . .  11
  65.           Comm port mask . . . . . . . . . . . . . . . . . . . . . . . .  11
  66.           Comm port vector . . . . . . . . . . . . . . . . . . . . . . .  11
  67.           IMPORTANT  . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  68.           Rows on screen . . . . . . . . . . . . . . . . . . . . . . . .  11
  69.           Use status line  . . . . . . . . . . . . . . . . . . . . . . .  11
  70.           Status line row  . . . . . . . . . . . . . . . . . . . . . . .  11
  71.           Status line background color . . . . . . . . . . . . . . . . .  11
  72.           Status line foreground color . . . . . . . . . . . . . . . . .  11
  73.           Anonymous (don't use showname() in scripts)  . . . . . . . . .  11
  74.           Sound bells when SLEARN.EXE is run . . . . . . . . . . . . . .  11
  75.           Use _entry_pass in scripts . . . . . . . . . . . . . . . . . .  12
  76.           Default Background Color . . . . . . . . . . . . . . . . . . .  12
  77.           Default Foreground Color . . . . . . . . . . . . . . . . . . .  12
  78.           Enable CTS/RTS flow control  . . . . . . . . . . . . . . . . .  12
  79.           Enable DSR/DTR flow control  . . . . . . . . . . . . . . . . .  12
  80.           Enable XON/XOFF flow control . . . . . . . . . . . . . . . . .  12
  81.  
  82.      Registration  . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.      SLEARN v1.10                                               Introduction
  90.  
  91.                                   Introduction
  92.  
  93.      Contacting the author
  94.      ---------------------
  95.      Hopefully, this documentation will tell you all you need to know about
  96.      using SLEARN.  But if necessary, please direct further questions to me
  97.      through the following means:
  98.  
  99.           Electronic mail:
  100.                BIX:           proub
  101.                Compuserve:    71131,157
  102.                Fido Netmail:  1:135/47
  103.           Messages to Paul Roub in the FidoNet TELIX echo
  104.           Local BBS messages to Paul Roub on MOBS (305-895-1666)
  105.           US Mail to:
  106.  
  107.                Paul Roub
  108.                P.O. Box 141583
  109.                Coral Gables, FL 33114-1583
  110.  
  111.      When reporting a bug, please be specific as to the nature of the prob-
  112.      lem -- what led up to it, what error message (if any) ensued, can you
  113.      repeat it, etc.
  114.  
  115.  
  116.      The author makes no claims as to the suitability of this product for
  117.      any application.  In the event of malfunction, the author's liability
  118.      shall be limited to a replacement or refund.
  119.  
  120.  
  121.      SLEARN v1.10 was compiled using Microsoft Quick C v2.0 for testing, and
  122.      Microsoft C v5.10 for release.  The editor used was Brief, without
  123.      which I'd just as soon live in a cave and code on stone tablets.
  124.  
  125.  
  126.      ACKNOWLEDGEMENTS:  Thanks to everyone who beta-tested this release for
  127.      your feedback, time and assistance.  Thanks to Andrew Adler, Lloyd
  128.      Burt, Craig Merwitzer and Bruce Wilson for testing and assistance above
  129.      and beyond the call of duty.  Thanks also to Nick Anis and John Dvorak. 
  130.      Special thanks to Lloyd Burt for more than I have space to list.  Par-
  131.      ticularly special thanks to Maria for making the last 2 1/2 years so
  132.      amazing.
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.      SLEARN Documentation                                             page 1
  143.  
  144.  
  145.  
  146.  
  147.  
  148.      SLEARN v1.10                                               Introduction
  149.  
  150.      Notes:
  151.      ------
  152.      You may distribute SLEARN freely (in fact, I would appreciate your
  153.      doing so), provided that you distribute only the full, unmodified ar-
  154.      chive (SLRN_110.ZIP), with its full name intact, containing the follow-
  155.      ing files:  
  156.  
  157.           SLEARN.DOC
  158.           SLRNHIST.DOC
  159.           SLEARN.REG
  160.           SLEARN.EXE
  161.           SLEARN.SLT
  162.           SLEARN.SLC
  163.           SLCONFIG.SLC
  164.           READTHIS.NOW  (Can be deleted after August 31, 1990)
  165.  
  166.      If you downloaded SLEARN from Compuserve, please rename SL110.ZIP to
  167.      SLRN_110.ZIP before distribution.  Feel free to distribute SLEARN in
  168.      other archive formats (such as ARC, LHARC, PAK, etc.) -- but again, you
  169.      must retain the full name, as in SLRN_110.LZH or SLRN_110.ARC.
  170.  
  171.      If you're not sure whether you have the latest version of SLEARN, the
  172.      following systems (among others) are always kept up to date:
  173.  
  174.           MOBS             (1:135/47)   305-895-1666
  175.           Floridays Deluxe (1:135/82)   305-235-2227
  176.           The C Workshop   (1:135/1)    305-226-3310
  177.           Telix Support BBS             416-439-8293
  178.           BIX telecomm listings area
  179.           Compuserve IBMCOM Forum
  180.  
  181.      If, after trying out SLEARN, you wish to continue using it, you must
  182.      fill out and send in the registration form at the end of this document. 
  183.      You'll be supporting shareware, making possible future improved ver-
  184.      sions of this and other programs; you will also receive the latest
  185.      version of SLEARN on disk.  Note that SLEARN may NOT be used in a bus-
  186.      iness or commercial environment without registration.  For further
  187.      details, see the Registration section at the end of this document.
  188.  
  189.      Is there something you don't like about SLEARN?  Something you think is
  190.      missing?  A screw-up in the documentation, etc...  let me know!  We aim
  191.      to please!
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.      SLEARN Documentation                                             page 2
  202.  
  203.  
  204.  
  205.  
  206.  
  207.      SLEARN v1.10                                            Why use SLEARN?
  208.  
  209.                                  Why use SLEARN?
  210.  
  211.      What's the problem?
  212.      -------------------
  213.      I've said it before -- Telix is the best communications program you'll
  214.      find.  Not even Telix is perfect, however.  Two common complaints go
  215.      hand in hand: that Telix's script language (SALT) can be difficult for
  216.      non-programmers to learn, and that Telix lacks a "learn" mode which can
  217.      automatically create SALT scripts for you.
  218.  
  219.      For example, suppose you wanted to log on to a QuickBBS system.  You
  220.      would connect to the BBS, wait until you saw the prompt
  221.  
  222.           Enter Your Name:
  223.  
  224.      then type your name, followed by a carriage return.  The system would
  225.      then prompt you for your
  226.  
  227.           Password:
  228.  
  229.      which you would also type, followed by another carriage return.  
  230.  
  231.      Of course, you don't want to have to go through this every time you log
  232.      onto that board -- the process will never change, and will get quite
  233.      boring (just the type of thing you expect your computer to spare you
  234.      from).  If you know SALT, Telix's script language, you could write a
  235.      script to log on for you, such as:
  236.  
  237.           main()
  238.           {
  239.             waitfor("Your Name:", 30);    // wait for name prompt
  240.             cputs("Paul Roub^M");         // if you're me, this works!
  241.  
  242.             waitfor("Password:", 30);     // wait for password prompt
  243.             cputs(_entry_pass);           // send the password stored in
  244.                                           //   this entry in the dialing
  245.                                           //   directory
  246.           }
  247.  
  248.      You would then compile this script, insert its name in your dialing
  249.      directory as the "linked script" for this system, and off you'd go. 
  250.      From now on, whenever you called this system, Telix would automatically
  251.      run this script and log on for you.
  252.  
  253.      While this is nice, there are two drawbacks:  it gets tedious when you
  254.      want to script more than a few prompts and responses, and some people
  255.      find SALT difficult to get the hang of.  It would be nice if Telix had
  256.      a "learn" mode.  A learn mode is a very useful feature, found in some
  257.      communications programs, which "watches" you as you perform some task. 
  258.      It notes what text is sent by the system you're connected to, what your
  259.  
  260.      SLEARN Documentation                                             page 3
  261.  
  262.  
  263.  
  264.  
  265.  
  266.      SLEARN v1.10                                            Why use SLEARN?
  267.  
  268.      responses are, and the time elapsed between them.  Using this informa-
  269.      tion, it writes a script which will wait for the same prompts and send
  270.      the same responses.  You would invoke this learn mode, log onto the
  271.      BBS, and the program would write the script FOR you!
  272.  
  273.  
  274.      What's the solution?
  275.      --------------------
  276.      Now, Telix DOES have a learn mode.  It's called SLEARN, the SALT learn
  277.      utility.  SLEARN will write your SALT scripts for you -- it will com-
  278.      pile the scripts, include them in your dialing directory and even name
  279.      them for you, all automatically!
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.      SLEARN Documentation                                             page 4
  320.  
  321.  
  322.  
  323.  
  324.  
  325.      SLEARN v1.10                                     Setup and Installation
  326.  
  327.                              Setup and Installation
  328.  
  329.      This manual assumes a basic understanding of .SLT (SALT script) versus
  330.      .SLC (compiled SALT) files, as well as an understanding of terms such
  331.      as "Logon Script" and "Dialing Directory".  If these terms are unfamil-
  332.      iar to you, consult your Telix manual.  If you have any problems using
  333.      SLEARN, and can't solve them with your DOS, SLEARN or Telix manuals,
  334.      please feel free to contact me through the means listed at the end of
  335.      this document.
  336.  
  337.      There are six essential files involved in using SLEARN.  These are:
  338.  
  339.           slearn.slt   - SALT script to run SLEARN from Telix
  340.           slearn.slc   - Compiled version of slearn.slt
  341.           slearn.exe   - The main SLEARN program
  342.           slconfig.slc - SLEARN configuration management script
  343.           slearn.cfg   - SLEARN configuration file (created by slconfig.slc)
  344.  
  345.      SLEARN.SLT, SLEARN.SLC, SLCONFIG.SLC and SLEARN.CFG should be kept in
  346.      the directory you have defined as your Telix script directory.  If you
  347.      haven't defined a script directory, simply place them in your main
  348.      Telix directory.  SLEARN.EXE should be in a directory listed in your
  349.      DOS PATH environment variable (consult your DOS manual for more infor-
  350.      mation about environment variables and the PATH).  If you do not have a
  351.      PATH statement, SLEARN.EXE should be in the same directory as
  352.      SLEARN.SLT and SLEARN.SLC.
  353.  
  354.           NOTE: If you are using Telix SE, you will not find SLEARN
  355.           very useful, as Telix SE does not come with the program
  356.           CS.EXE, needed to compile the SALT scripts created by SLEARN. 
  357.           In this case, you will need to register your copy of Telix
  358.           (see the Telix coupon in the Dvorak book for details), or
  359.           find a BBS which has the Telix archives available (and use
  360.           Telix SE to download them) to get the full version of Telix.
  361.  
  362.      By default, SLEARN will modify your Telix dialing directory
  363.      (TELIX.FON).  If, however, you will be using more than one dialing
  364.      directory, you won't want to do this -- SLEARN always modifies
  365.      TELIX.FON, whether or not it is the current dialing directory (Telix
  366.      provides no way for a script or external program to check the name of
  367.      the currently loaded dialing directory).  If you want to change this
  368.      behavior, change this line (in SLEARN.SLT)
  369.  
  370.           int       UseSetScr = 1;
  371.      to
  372.           int       UseSetScr = 0;
  373.  
  374.  
  375.  
  376.  
  377.  
  378.      SLEARN Documentation                                             page 5
  379.  
  380.  
  381.  
  382.  
  383.  
  384.      SLEARN v1.10                                     Setup and Installation
  385.  
  386.      If you make any changes to SLEARN.SLT, you will need to re-compile it
  387.      for the changes to be effective.  To do this, go to your Telix script
  388.      directory and enter the command:
  389.  
  390.           CS slearn
  391.  
  392.      at the DOS prompt.  This will create a new version of SLEARN.SLC, the
  393.      compiled version of SLEARN.SLT.
  394.  
  395.      I recommend running SLCONFIG.SLC (through Telix's Alt-G command) when
  396.      you first install SLEARN, in order to create and initialize SLEARN.CFG. 
  397.      If you don't do this, SLEARN.SLC will automatically run the configura-
  398.      tion script when you first run SLEARN -- a delay you certainly won't
  399.      want at that time!  See the section entitled "Configuration Options"
  400.      for an explanation of the options available through SLCONFIG.
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.      SLEARN Documentation                                             page 6
  438.  
  439.  
  440.  
  441.  
  442.  
  443.      SLEARN v1.10                                               Using SLEARN
  444.  
  445.                                   Using SLEARN
  446.  
  447.      The easiest, most automatic way to use SLEARN is through the SLEARN.SLT
  448.      script.  Just use TFE or Telix to insert 'slearn' in the Script field
  449.      for that system's dialing directory entry.  Then, dial that system from
  450.      Telix.  When Telix connects to the other system, it will automatically
  451.      run SLEARN.  Alternatively, if you are already connected, SLEARN can be
  452.      run via Telix's Alt-G (Run Script) command.
  453.  
  454.      Once SLEARN is running, simply go through the actions you wish to auto-
  455.      mate, just as if you were using Telix.  That is, when (for example) the
  456.      system asks for your name or password, just enter them as usual.  "Wri-
  457.      ting" the SALT script is as easy as that!  As a bonus, if you run
  458.      SLEARN as the connect script for a dialing directory entry, and you
  459.      have a password defined for that entry, you can just hit the F1 or F3
  460.      key to send your password for you (the SLEARN.SLC script will automat-
  461.      ically tell SLEARN what your password is -- unless you tell it not to,
  462.      as explained in the Configuration Options section).
  463.  
  464.           NOTE:  Keep in mind that SLEARN is not Telix.  You can re-
  465.           ceive and send text while using SLEARN, but you can not ac-
  466.           cess the Telix dialing directory, file transfers, or any
  467.           other Telix features; this means that none of these functions
  468.           may be "learned".  As an alternative, try "learning" a pro-
  469.           cess up to the last step before a file transfer, for example. 
  470.           Afterwards, you can either add the transfer command to the
  471.           script yourself, or perform the transfer manually when the
  472.           script is run.  Either way, SLEARN gives you a head start on
  473.           automating the process.
  474.  
  475.      When you are done with the steps you wish to automate, hit Alt-X to
  476.      tell SLEARN to write the SALT script for what you have just done, and
  477.      return to Telix.
  478.  
  479.      At this point, SLEARN will ask you whether you want to save the script
  480.      you have just created.  If you answer "no", the script will be deleted. 
  481.      Otherwise, SLEARN will ask you what name to use for the new script --
  482.      hit ENTER alone to choose the default name, which SLEARN "guesses"
  483.      based on the name of the system you're connected to.  SLEARN will then
  484.      run CS.EXE to compile the script (it is important that CS.EXE be pres-
  485.      ent either in your Telix script directory, or in a directory listed in
  486.      your DOS PATH -- otherwise, SLEARN will not be able to locate and run
  487.      the program).  And if you have not set "UseSetScr = 0" (as explained in
  488.      the Setup and Configuration section), SLEARN will ask if you want to
  489.      install the name of the new script as the logon script for this entry. 
  490.      If you answer "yes", SLEARN will do so -- replacing the 'slearn' you
  491.      had entered with the name of the new script.
  492.  
  493.  
  494.  
  495.  
  496.      SLEARN Documentation                                             page 7
  497.  
  498.  
  499.  
  500.  
  501.  
  502.      SLEARN v1.10                                               Using SLEARN
  503.  
  504.           WARNING: it is important that you have a dummy FON file named
  505.           ZZZ.FON in your Telix directory.  If you do not have such a file,
  506.           the SLEARN script will create one for you by copying TELIX.FON to
  507.           ZZZ.FON.  This file is loaded into Telix when TELIX.FON is being
  508.           modified, to avoid modifying a file which Telix is currently
  509.           using.
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.      SLEARN Documentation                                             page 8
  556.  
  557.  
  558.  
  559.  
  560.  
  561.      SLEARN v1.10                                         Command-Line Usage
  562.  
  563.                                Command-Line Usage
  564.  
  565.      There may be times when you wish to use the SLEARN program itself,
  566.      outside of Telix or without the use of the SLEARN.SLT script.  The
  567.      SLEARN program takes the following parameters (all parameters in brack-
  568.      ets are optional):
  569.  
  570.      slearn [-n <s>] [-b<n>] [-s<s>] [-w <s>] filename
  571.  
  572.      The parameters have the following effects:
  573.  
  574.      -n <s>    Sets entry name to <s>.  This option is used by SLEARN.SLT so
  575.                that SLEARN can correctly note what board it is learning a
  576.                script for.  This name is included near the top of the
  577.                learned script file.  If the string is blank, no "Automatic
  578.                logon script for..." line is included in the learned script. 
  579.                If present, this name will also be displayed on SLEARN's
  580.                status line while learning the script.
  581.  
  582.      -b<n>     Sets bps rate to <n>.  This tells SLEARN what speed your
  583.                modem will use.  The default is 2400 bps.
  584.  
  585.      -s<s>     Sets parity, data, stop to <s>.  This option sets the parity,
  586.                data bits, and stop bits parameters SLEARN will use when
  587.                communicating.  This should be a three-character string, the
  588.                first character being "N", "E", or "O" to represent No par-
  589.                ity, Even parity, or Odd parity;  the next character will be
  590.                7 or 8, depending on the number of data bits;  and the final
  591.                character should be 1 or 2 to set the number of stop bits to
  592.                use.  Common settings are "E71" and "N81" -- the default is
  593.                "N81".
  594.  
  595.      -w <s>    Sets the password for this script.  This is useful for two
  596.                reasons.  First of all, when running SLEARN you can send your
  597.                password (followed by a carriage return) simply by pressing
  598.                F1 or F3.  Second, whenever you send your password (by typing
  599.                it or by F1 or F3), SLEARN recognizes it, and instead of
  600.                including the literal password in the script, it uses Telix's
  601.                _entry_pass variable, which is always set to the name of the
  602.                system you are connected to (as stored in the dialing direc-
  603.                tory).  This has two benefits:  (1) you can let other people
  604.                have copies of the script without giving away your password;
  605.                and (2) if you use more than one system with the same logon
  606.                sequence, but a different password, you can use the same
  607.                script for all of them -- the script will always send the
  608.                appropriate password for each system.
  609.  
  610.  
  611.  
  612.  
  613.  
  614.      SLEARN Documentation                                             page 9
  615.  
  616.  
  617.  
  618.  
  619.  
  620.      SLEARN v1.10                                         Command-Line Usage
  621.  
  622.      filename  Name of the SALT file to create.  This is the only parameter
  623.                REQUIRED by SLEARN.  This is the filename of the script
  624.                SLEARN will be learning.  If you specify a name without an
  625.                extension, the extension .SLT will be used automatically.
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.      SLEARN Documentation                                            page 10
  674.  
  675.  
  676.  
  677.  
  678.  
  679.      SLEARN v1.10                                      Configuration Options
  680.  
  681.                               Configuration Options
  682.  
  683.  
  684.      Comm port address
  685.      Comm port mask
  686.      Comm port vector
  687.           These tell SLEARN the exact nature of your serial port setup.
  688.  
  689.           IMPORTANT: You will probably never need to change these numbers. 
  690.                SLCONFIG. when initially run, will calculate the correct val-
  691.                ues based on information in TELIX.CNF.
  692.  
  693.      Rows on screen
  694.           The number of lines on your screen, INCLUDING the status line (if
  695.           any).
  696.  
  697.      Use status line
  698.           Set this to 'y' (yes) if you use a on-screen status line in Telix.
  699.  
  700.      Status line row
  701.           The row at which your Telix status line is displayed.  This has no
  702.           effect if "Use status line" is set to 'n' (no).
  703.  
  704.      Status line background color
  705.      Status line foreground color
  706.           The colors used for your status line (if any).
  707.  
  708.      Anonymous (don't use showname() in scripts)
  709.           SLEARN normally includes (in the learned script) a call to a func-
  710.           tion called showname(), which displays the name of the system to
  711.           which you are connected (actually, only the first 14 characters of
  712.           the name are displayed).  This name overwrites Telix's "Alt-z for
  713.           help" message -- I consider the extra information to be worth the
  714.           sacrifice, but if it bothers you, set this option to 'y' (yes).
  715.  
  716.      Sound bells when SLEARN.EXE is run
  717.           Sounds control-G's (bells) when SLEARN is run.  This is normally
  718.           used when SLEARN is run from a dialing directory entry, so that
  719.           you'll know a connection has been made.  The reason I haven't just
  720.           included an alarm() command in the SLEARN.SLT script is that
  721.           during the time that the alarm is sounding, some characters may be
  722.           received by Telix from the remote.  SLEARN will not see any of
  723.           these characters, which may make creating a logon script for that
  724.           board impossible.  Basically, the object is to get SLEARN itself
  725.           running as soon as possible after a connection has been made, so
  726.           that ALL prompts you may need can be processed by SLEARN.  This
  727.           option probably won't be too useful from the DOS command line.
  728.  
  729.  
  730.  
  731.  
  732.      SLEARN Documentation                                            page 11
  733.  
  734.  
  735.  
  736.  
  737.  
  738.      SLEARN v1.10                                      Configuration Options
  739.  
  740.      Use _entry_pass in scripts
  741.           Normally, the SLEARN script checks for your current password.  If
  742.           it is present, you can send your password by simply pressing the
  743.           F1 or F3 keys.  Also, SLEARN will replace any transmission of your
  744.           password with a reference to _entry_pass, so the script can be
  745.           used with multiple systems, always sending the correct password. 
  746.           Set this option to 'n' (no) to disable special password process-
  747.           ing.
  748.  
  749.      Default Background Color
  750.      Default Foreground Color
  751.           The colors SLEARN should initially use for its terminal screen.
  752.  
  753.      Enable CTS/RTS flow control
  754.      Enable DSR/DTR flow control
  755.      Enable XON/XOFF flow control
  756.           These options enable various types of hardware and software "hand-
  757.           shaking" -- used to control the flow of data between your com-
  758.           puter, your modem and the modem you're connected to.  These op-
  759.           tions are read from your Telix configuration file when SLCONFIG is
  760.           run for the first time, so there should be no need to change them.
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.      SLEARN Documentation                                            page 12
  792.  
  793.  
  794.  
  795.  
  796.  
  797.      SLEARN v1.10                                         Registering SLEARN
  798.  
  799.                                   Registration
  800.  
  801.  
  802.           NOTE: SLEARN may NOT be used in a business or commercial
  803.           environment without registration.
  804.  
  805.      SLEARN is distributed as shareware.  The advantage of this is that you
  806.      get to try out the full, working program and see whether or not it
  807.      suits your needs.  If you find SLEARN useful, you must register the
  808.      program.  Just to prod your good will along, registration has a few
  809.      perks: you will receive the latest version of SLEARN on disk, along
  810.      with inexpensive on-disk updates to future versions.  Comments, sugges-
  811.      tions, and requests from registered users will of course have higher
  812.      priority.  Without registrations, there will soon cease to BE future
  813.      versions of SLEARN, simply because I've got to make a living, and I
  814.      have no choice but to devote the bulk of my time to projects that will
  815.      help me pay my bills.
  816.  
  817.      To register SLEARN, just fill out the registration form below; be sure
  818.      to include your check or money order (in US Dollars), and mail it to
  819.      the address below.  Basic registration is ten dollars, including ship-
  820.      ping, handling, and the cost of a floppy disk (5 1/4", MS-DOS DS/DD,
  821.      with the latest version of SLEARN).  Registered users of previous
  822.      SLEARN versions can upgrade to the latest version for five dollars.  Of
  823.      course, once you've registered one version of SLEARN, you've registered
  824.      all future versions as well -- so you can simply download the latest
  825.      version from a BBS.  I provide the upgrade service for those who can't
  826.      find the latest version elsewhere.
  827.  
  828.      For a special price of only $15, you can register both SLEARN and TFE
  829.      (TelixFonEd), receiving both on disk, along with a collection of Telix
  830.      scripts, tips and utilities.
  831.  
  832.      Thank you for registering SLEARN.
  833.  
  834.      The registration form follows.
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.      SLEARN Documentation                                            page 13
  851.  
  852.  
  853.  
  854.  
  855.  
  856.      SLEARN v1.10                                         Registering SLEARN
  857.  
  858.      Please send this form, along with your check or money order for the
  859.      appropriate amount of US dollars, to:
  860.  
  861.           Paul Roub
  862.           P.O. Box 141583
  863.           Coral Gables, FL  33114-1583
  864.  
  865.  
  866.      I would like to register SLEARN in the following manner (check one):
  867.  
  868.  
  869.      __ Regular registration (with the latest version on disk)        $10.00
  870.  
  871.      __ Previously registered user, upgrading to the latest version   $ 5.00
  872.  
  873.      __ Register SLEARN and TFE, plus bonus scripts and utilities     $15.00
  874.  
  875.  
  876.      Name:               ___________________________________________________
  877.  
  878.      Company:            ___________________________________________________
  879.  
  880.      Street Address:     ___________________________________________________
  881.  
  882.      City, ST:           ___________________________________________________
  883.  
  884.      Zip:                _____________
  885.  
  886.      Home phone number (optional): (_____)-______________
  887.  
  888.      Work phone number (optional): (_____)-______________
  889.  
  890.  
  891.      BIX, CIS or Netmail addresses (optional): _____________________________
  892.  
  893.  
  894.      Where did you find SLEARN?  ___________________________________________
  895.  
  896.  
  897.      Comments and/or Suggestions:  _________________________________________
  898.  
  899.      _______________________________________________________________________
  900.  
  901.      _______________________________________________________________________
  902.  
  903.      _______________________________________________________________________
  904.  
  905.      _______________________________________________________________________
  906.  
  907.  
  908.  
  909.      SLEARN Documentation                                            page 14
  910.